Get Business Data Tripadvisor Reviews Results by id
This endpoint provides feedback data on businesses listed on the Tripadvisor platform, including their locations, ratings, review content and count. The results are specific to the URL path indicated in the POST request.
We emulate set parameters with the highest accuracy so that the results you receive will match the actual search results for the specified parameters at the time of task setting. You can always check the returned results accessing the check_url in the Incognito mode to make sure the received data is entirely relevant. Note that user preferences, search history, and other personalized search factors are ignored by our system and thus would not be reflected in the returned results.
Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-dashboard
# Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-dashboard
login="login"
password="password"
cred="$(printf ${login}:${password} | base64)"
id="04011058-0696-0199-0000-2196151a15cb"
curl --location --request GET "https://api.dataforseo.com/v3/business_data/tripadvisor/reviews/task_get/${id}"
--header "Authorization: Basic ${cred}"
--header "Content-Type: application/json"
<?php
// You can download this file from here https://cdn.dataforseo.com/v3/examples/php/php_RestClient.zip
require('RestClient.php');
$api_url = 'https://api.dataforseo.com/';
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-dashboard
$client = new RestClient($api_url, null, 'login', 'password');
try {
$result = array();
// #1 - using this method you can get a list of completed tasks
// GET /v3/business_data/tripadvisor/reviews/tasks_ready
$tasks_ready = $client->get('/v3/business_data/tripadvisor/reviews/tasks_ready');
// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if (isset($tasks_ready['status_code']) AND $tasks_ready['status_code'] === 20000) {
foreach ($tasks_ready['tasks'] as $task) {
if (isset($task['result'])) {
foreach ($task['result'] as $task_ready) {
// #2 - using this method you can get results of each completed task
// GET /v3/business_data/tripadvisor/reviews/task_get/$id
if (isset($task_ready['endpoint'])) {
$result[] = $client->get($task_ready['endpoint']);
}
// #3 - another way to get the task results by id
// GET /v3/business_data/tripadvisor/reviews/task_get/$id
/*
if (isset($task_ready['id'])) {
$result[] = $client->get('/v3/business_data/tripadvisor/reviews/task_get/' . $task_ready['id']);
}
*/
}
}
}
}
print_r($result);
// do something with result
} catch (RestClientException $e) {
echo "n";
print "HTTP code: {$e->getHttpCode()}n";
print "Error code: {$e->getCode()}n";
print "Message: {$e->getMessage()}n";
print $e->getTraceAsString();
echo "n";
}
$client = null;
?>
from client import RestClient
# You can download this file from here https://cdn.dataforseo.com/v3/examples/python/python_Client.zip
client = RestClient("login", "password")
# 1 - using this method you can get a list of completed tasks
# GET /v3/business_data/tripadvisor/reviews/tasks_ready
response = client.get("/v3/business_data/tripadvisor/reviews/tasks_ready")
# you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if response['status_code'] == 20000:
results = []
for task in response['tasks']:
if (task['result'] and (len(task['result']) > 0)):
for resultTaskInfo in task['result']:
# 2 - using this method you can get results of each completed task
# GET /v3/business_data/tripadvisor/reviews/task_get/$id
if(resultTaskInfo['endpoint']):
results.append(client.get(resultTaskInfo['endpoint']))
'''
# 3 - another way to get the task results by id
# GET /v3/business_data/tripadvisor/reviews/task_get/$id
if(resultTaskInfo['id']):
results.append(client.get("/v3/business_data/tripadvisor/reviews/task_get/" + resultTaskInfo['id']))
'''
print(results)
# do something with result
else:
print("error. Code: %d Message: %s" % (response["status_code"], response["status_message"]))
using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
namespace DataForSeoDemos
{
public static partial class Demos
{
public static async Task business_data_tripadvisor_reviews_task_get()
{
var httpClient = new HttpClient
{
BaseAddress = new Uri("https://api.dataforseo.com/"),
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-dashboard
DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue("Basic", Convert.ToBase64String(Encoding.ASCII.GetBytes("login:password"))) }
};
// #1 - using this method you can get a list of completed tasks
// GET /v3/business_data/tripadvisor/reviews/tasks_ready
var response = await httpClient.GetAsync("/v3/business_data/tripadvisor/reviews/tasks_ready");
var tasksInfo = JsonConvert.DeserializeObject<<dynamic>>(await response.Content.ReadAsStringAsync());
var tasksResponses = new List<<object>>();
// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if (tasksInfo.status_code == 20000)
{
if (tasksInfo.tasks != null)
{
foreach (var tasks in tasksInfo.tasks)
{
if (tasks.result != null)
{
foreach (var task in tasks.result)
{
if (task.endpoint != null)
{
// #2 - using this method you can get results of each completed task
// GET /v3/business_data/tripadvisor/reviews/task_get/$id
var taskGetResponse = await httpClient.GetAsync((string)task.endpoint);
var taskResultObj = JsonConvert.DeserializeObject<<dynamic>>(await taskGetResponse.Content.ReadAsStringAsync());
if (taskResultObj.tasks != null)
{
var fst = taskResultObj.tasks.First;
// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if (fst.status_code >= 40000 || fst.result == null)
Console.WriteLine($"error. Code: {fst.status_code} Message: {fst.status_message}");
else
tasksResponses.Add(fst.result);
}
// #3 - another way to get the task results by id
// GET /v3/business_data/tripadvisor/reviews/task_get//$id
/*
var tasksGetResponse = await httpClient.GetAsync("/v3/business_data/tripadvisor/reviews/task_get/" + (string)task.id);
var taskResultObj = JsonConvert.DeserializeObject<<dynamic>>(await tasksGetResponse.Content.ReadAsStringAsync());
if (taskResultObj.tasks != null)
{
var fst = taskResultObj.tasks.First;
// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if (fst.status_code >= 40000 || fst.result == null)
Console.WriteLine($"error. Code: {fst.status_code} Message: {fst.status_message}");
else
tasksResponses.Add(fst.result);
}
*/
}
}
}
}
}
if (tasksResponses.Count > 0)
// do something with result
Console.WriteLine(String.Join(Environment.NewLine, tasksResponses));
else
Console.WriteLine("No completed tasks");
}
else
Console.WriteLine($"error. Code: {tasksInfo.status_code} Message: {tasksInfo.status_message}");
}
}
}
The above command returns JSON structured like this:
{
"version": "0.1.20210917",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0726 sec.",
"cost": 0,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "10291836-1535-0353-0000-25bf1a00c837",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0458 sec.",
"cost": 0,
"result_count": 1,
"path": [
"v3",
"business_data",
"tripadvisor",
"reviews",
"task_get",
"10291836-1535-0353-0000-25bf1a00c837"
],
"data": {
"api": "business_data",
"function": "reviews",
"se": "tripadvisor",
"url_path": "Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
"pingback_url": "https://your-server.com/pingback.php?id=$id&tag=$tag",
"tag": "test",
"se_depth": 10,
"language_name": "English",
"language_code": "en",
"location_name": "United States",
"device": "desktop",
"os": "windows"
},
"result": [
{
"url_path": "Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
"type": "tripadvisor_reviews",
"se_domain": "tripadvisor.com",
"check_url": "https://www.tripadvisor.com/Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
"datetime": "2021-10-29 15:36:56 +00:00",
"title": "Margaritaville Resort Times Square",
"location": "560 Seventh Ave, New York City, NY 10018",
"reviews_count": 98,
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"items_count": 10,
"items": [
{
"type": "tripadvisor_review_search",
"rank_group": 1,
"rank_absolute": 1,
"position": "left",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r816459565-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"date_of_visit": "2021-10-31 00:00:00 +00:00",
"timestamp": "2021-10-28 00:00:00 +00:00",
"title": "Travel Agent Review of Margaritaville Times Square",
"review_text": "I am a travel agent and owner of BNBTRAVELANDCRUISES.COM. I completed a site inspection and FAM visit. Below is my email to the team on site:\n\nI wanted to thank you and your team for the wonderful hospitality shown during my FAM stay last week! Breakfast by the pool with retractable doors was fantastic, the staff were very helpful, friendly and extremely accommodating. The room was amazing, the ambiance on the 31st and 7th floor outdoor areas was great, and inside the room I felt like I was on a Caribbean island. Loved the dolphin tail faucets on the bathroom sink, the slippers, robe, the trunk inspired dressers, and the sliding bathroom door! I appreciated the staff at the entrance which made me feel safe. Oh, and you're within walking distance to everything! I was able to walk to the theater, Times Square and shop on 5th Ave. You're also within waking distance of the Port Authority where I hopped on a bus to Woodbury Commons. There are plenty of restaurants nearby as well as drugs stores for last minute items. However, the resort also has plenty of food options. The rooms are equipped with refrigerators to store beverages or food. I have been raving to everyone about the Resort and will definitely book my clients there. \n\nThere was elevator wait time especially during peak hours, but it didn't bother me.",
"review_images": [
{
"url": "https://media-cdn.tripadvisor.com/media/photo-o/21/35/1c/15/margaritaville-resort.jpg"
},
{
"url": "https://media-cdn.tripadvisor.com/media/photo-o/21/35/1c/14/margaritaville-resort.jpg"
},
{
"url": "https://media-cdn.tripadvisor.com/media/photo-w/21/35/1e/16/margaritaville-resort.jpg"
},
{
"url": "https://media-cdn.tripadvisor.com/media/photo-w/21/35/1e/60/margaritaville-resort.jpg"
},
{
"url": "https://media-cdn.tripadvisor.com/media/photo-o/21/35/1c/10/margaritaville-resort.jpg"
},
{
"url": "https://media-cdn.tripadvisor.com/media/photo-w/21/35/1e/5c/margaritaville-resort.jpg"
},
{
"url": "https://media-cdn.tripadvisor.com/media/photo-m/1280/21/35/1e/3c/margaritaville-resort.jpg"
},
{
"url": "https://media-cdn.tripadvisor.com/media/photo-w/21/35/1e/09/margaritaville-resort.jpg"
},
{
"url": "https://media-cdn.tripadvisor.com/media/photo-o/21/35/1c/18/margaritaville-resort.jpg"
},
{
"url": "https://media-cdn.tripadvisor.com/media/photo-w/21/35/1e/5a/margaritaville-resort.jpg"
}
],
"user_profile": {
"name": "Sharon J",
"url": "https://www.tripadvisor.com/Profile/sharonjE9610JV",
"image_url": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/e2/a7/default-avatar-2020-44.jpg",
"location": null,
"reviews_count": 11
},
"responses": null
},
{
"type": "tripadvisor_review_search",
"rank_group": 2,
"rank_absolute": 2,
"position": "left",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r816322393-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"date_of_visit": "2021-10-31 00:00:00 +00:00",
"timestamp": "2021-10-28 00:00:00 +00:00",
"title": "Will be back",
"review_text": "Love love love this place. Couldn't do all in 1 weekend. Rooms are unique which I love, views were great. Watching the sunset was amazing. This is my go to place once a month, was having to much fun to take more pic but will on my next visit",
"review_images": [
{
"url": "https://media-cdn.tripadvisor.com/media/photo-w/21/26/cc/70/margaritaville-resort.jpg"
},
{
"url": "https://media-cdn.tripadvisor.com/media/photo-w/21/26/cc/61/margaritaville-resort.jpg"
},
{
"url": "https://media-cdn.tripadvisor.com/media/photo-w/21/26/cb/ee/margaritaville-resort.jpg"
},
{
"url": "https://media-cdn.tripadvisor.com/media/photo-w/21/26/cc/5f/margaritaville-resort.jpg"
},
{
"url": "https://media-cdn.tripadvisor.com/media/photo-w/21/26/cc/5c/margaritaville-resort.jpg"
}
],
"user_profile": {
"name": "Tanya B",
"url": "https://www.tripadvisor.com/Profile/Empresstanya",
"image_url": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/f2/7a/default-avatar-2020-25.jpg",
"location": null,
"reviews_count": 7
},
"responses": null
},
{
"type": "tripadvisor_review_search",
"rank_group": 3,
"rank_absolute": 3,
"position": "left",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r815986755-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"date_of_visit": "2021-10-31 00:00:00 +00:00",
"timestamp": "2021-10-25 00:00:00 +00:00",
"title": "Great Stay, great room, Highly Recommend",
"review_text": "The rooms were very clean and bright, a little small but perfect. There are USB ports and plugs everywhere. The staff from the front desk to the maintenance personnel were very friendly and extremely helpful.",
"review_images": null,
"user_profile": {
"name": "ROBIN S",
"url": "https://www.tripadvisor.com/Profile/13ROBINS",
"image_url": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/ed/00/default-avatar-2020-4.jpg",
"location": null,
"reviews_count": 3
},
"responses": [
{
"title": "Lauren Nordstrom",
"text": "Hi 13ROBINS,\n\nThank you for your feedback on our cleanliness, cozy and convenient room design, and sincere service! We are pleased to hear that you had an exciting stay with us! We hope you will join us for another New York adventure soon!\n\nWarm Regards,\nLauren Nordstrom\nDirector of the Front Office",
"timestamp": "2021-10-27 00:00:00 +00:00"
}
]
},
{
"type": "tripadvisor_review_search",
"rank_group": 4,
"rank_absolute": 4,
"position": "left",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r815558984-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"date_of_visit": "2021-10-31 00:00:00 +00:00",
"timestamp": "2021-10-22 00:00:00 +00:00",
"title": "Awesome place to stay near Times Square",
"review_text": "The room was very nice - modern and clean. Lots of USB ports for devices everywhere. Good location, also, just a block or 2 from Times Square. The view from our room was nice. The staff was great. I’d book here again. Only thing I didn’t like was the shower - which is super fancy and absolutely beautiful but without a shower door. Part of the aesthetic that made it look so cool but it made me feel a little “exposed” and like I had to worry about water splashing out into the bathroom.",
"review_images": [
{
"url": "https://media-cdn.tripadvisor.com/media/photo-w/20/c5/5b/79/caption.jpg"
}
],
"user_profile": {
"name": "Dara L",
"url": "https://www.tripadvisor.com/Profile/695daras",
"image_url": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/f4/5d/default-avatar-2020-32.jpg",
"location": null,
"reviews_count": 2
},
"responses": [
{
"title": "Lauren Nordstrom",
"text": "Hi Dara L,\n\nThank you for your valuable feedback! We are delighted to hear that you enjoyed many aspects of your stay with us, especially, our modern design, cleanliness, convenient location, city views, and sincere service! You made a great recommendation for improvement which we will take into serious consideration to improve our guest's stay. We thank you for your patronage and hope you will join us for another New York adventure soon!\n\nWarm Regards,\nLauren Nordstrom\nDirector of the Front Office",
"timestamp": "2021-10-24 00:00:00 +00:00"
}
]
},
{
"type": "tripadvisor_review_search",
"rank_group": 5,
"rank_absolute": 5,
"position": "left",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r815487647-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"date_of_visit": "2021-10-31 00:00:00 +00:00",
"timestamp": "2021-10-21 00:00:00 +00:00",
"title": "Highly Recommend",
"review_text": "Beautiful hotel- very clean and all staff were friendly. Felt very safe with Covid precautions in place. Staff were very helpful with recommendations for places to eat. The hotel had two really nice rooftop bars. Great experience and would highly recommend!",
"review_images": null,
"user_profile": {
"name": "Bill",
"url": "https://www.tripadvisor.com/Profile/Billsta85",
"image_url": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/e7/7b/default-avatar-2020-56.jpg",
"location": null,
"reviews_count": 1
},
"responses": [
{
"title": "Lauren Nordstrom",
"text": "Hi Billsta85,\n\nThank you for your feedback! We are pleased to hear that you enjoyed your stay with us, especially, our cleanliness, safety precautions, Rooftop Bars, and service that our staff was able to provide! We thank you for your patronage and hope to welcome you back to our Resort soon.\n\nWarm Regards,\nLauren Nordstrom\nDirector of the Front Office",
"timestamp": "2021-10-24 00:00:00 +00:00"
}
]
},
{
"type": "tripadvisor_review_search",
"rank_group": 6,
"rank_absolute": 6,
"position": "left",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r815470687-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"date_of_visit": "2021-10-31 00:00:00 +00:00",
"timestamp": "2021-10-21 00:00:00 +00:00",
"title": "Fun!",
"review_text": "What a fun place to stay! Although we were in the middle of NYC's busiest area, we felt insulated from the noise and bustle of Tines Square. The whole hotel gives you a feeling of being of warmth and relaxation. My husband loved the heated pool, even in mid-October. Food at the Landshark Grill was delicious, the different bars were comfy, and the room nicely appointed. As others have noted, the rooms are small. Don't expect to have a lot of space to spread out. But the bed in comfortable and that's important!\nWe cannot say enough about the staff. From security, to front desk, to waitstaff, bartenders, housekeeping - all were friendly and helpful. Don't think we have ever experienced such consistently well-trained staff anywhere. Management is to be congratulated. \nWill definitely return!",
"review_images": null,
"user_profile": {
"name": "Mimi M",
"url": "https://www.tripadvisor.com/Profile/MimiM292",
"image_url": "https://media-cdn.tripadvisor.com/media/photo-o/05/31/5f/a9/mimi-m.jpg",
"location": "Hartford, Connecticut",
"reviews_count": 17
},
"responses": [
{
"title": "Lauren Nordstrom",
"text": "Hi MimiM292,\n\nWe are thrilled that Margaritaville Resort Times Square was the perfect fit for you! Thank you for your feedback on our relaxed atmosphere, heated pool, Food and Beverage venues, and sincere service! Please feel free to reach out to me directly before your next trip so that I can oversee your stay and handle any special requests you might have.\n\nThank you for choosing Margaritaville Resort Times Square!\n\nWarm Regards,\nLauren Nordstrom\nDirector of the Front Office\nLNordstrom@margaritavilleresortnyc.com",
"timestamp": "2021-10-24 00:00:00 +00:00"
}
]
},
{
"type": "tripadvisor_review_search",
"rank_group": 7,
"rank_absolute": 7,
"position": "left",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r815427260-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"date_of_visit": "2021-10-31 00:00:00 +00:00",
"timestamp": "2021-10-21 00:00:00 +00:00",
"title": "Awesome Hotel near Times Square",
"review_text": "Wasn't sure when I booked 3 night stay if I'd like the hotel. However, once you enter the property I was convinced I had made the right choice. My wife and I brought my mom to NYC (on her bucket list) and she is 82 yrs old. Very clean, bright and great vibe. We enjoyed the 3 roof top bars! Rooms were comfortable and had a homey feel with a Key West taste, Loved it and would book my next stay in NYC at the Margaritaville Resort. Mark, Cierra Abhi were awesome and very informative; they made great recommendations. I will be telling anyone going to NYC to stay here!",
"review_images": null,
"user_profile": {
"name": "Bradley M",
"url": "https://www.tripadvisor.com/Profile/231bradleym",
"image_url": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/f1/42/default-avatar-2020-20.jpg",
"location": null,
"reviews_count": 1
},
"responses": [
{
"title": "Lauren Nordstrom",
"text": "Hi 231bradleym,\n\nThank you for your feedback! We are pleased to hear that you and your family enjoyed your overall stay with us, especially, our cleanliness, Rooftop Bar, tropical design, and service that Mark, Ciera, and Abhi were able to provide! We look forward to welcoming you back soon!\n\nWarm Regards,\nLauren Nordstrom\nDirector of the Front Office",
"timestamp": "2021-10-22 00:00:00 +00:00"
}
]
},
{
"type": "tripadvisor_review_search",
"rank_group": 8,
"rank_absolute": 8,
"position": "left",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r815342488-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"date_of_visit": "2021-09-30 00:00:00 +00:00",
"timestamp": "2021-10-20 00:00:00 +00:00",
"title": "island vibe gem in nyc theater district",
"review_text": "We stayed at island themed hotel to celebrate our anniversary. From the moment you arrive you are greeted by a warm and friendly staff and know you made the right decision in stay here. Cannot say enough positive things about the staff especially Yissel, Ciera and Ori . They went above and beyond to make us feel special and spoiled and even sent up a treat to our room to celebrate our anniversary. Hotel is immaculately clean , hand sanitizer stations at all elevators and clear that they want guest know they are taking covid protocols seriously. We stayed up on 27th floor in deluxe room. Beautifully appointed room with bed that is so comfortable you'll be dreaming in no time. Gorgeous sea green glass shower with design detail of whales tail for faucet knobs on sink. It really is a slice of paradise in busy NYC. Short walk to theaters and time square. The roof top bar had wonderful drinks and lovely view of city and the crystal ball that rings in the new year. You'll be chilled and relaxed in no time at all.",
"review_images": null,
"user_profile": {
"name": "Amfh342",
"url": "https://www.tripadvisor.com/Profile/Amfh342",
"image_url": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/e4/ca/default-avatar-2020-51.jpg",
"location": "Norwell, Massachusetts",
"reviews_count": 2
},
"responses": [
{
"title": "Lauren Nordstrom",
"text": "Hi Amfh342,\n\nThank you for taking the time to write a review after your recent stay at Margaritaville Resort Times Square! We are delighted to hear that you enjoyed many aspects of your stay with us, especially, our cleanliness, room design, convenient location, Rooftop Bar, and service that Yissel, Ciera, and Orin were able to provide! Guests like you are a joy to host and we hope to welcome you back to our Resort soon!\n\nWarm Regards,\nLauren Nordstrom \nDirector of the Front Office",
"timestamp": "2021-10-22 00:00:00 +00:00"
}
]
},
{
"type": "tripadvisor_review_search",
"rank_group": 9,
"rank_absolute": 9,
"position": "left",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r815331150-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"date_of_visit": "2021-10-31 00:00:00 +00:00",
"timestamp": "2021-10-20 00:00:00 +00:00",
"title": "A Caribbean Island in Times Square.",
"review_text": "I just stayed here for a one-night getaway. I spent the afternoon at the pool where the very friendly wait-staff brought me Margaritas and a cheeseburger. The rooftop 5 O'clock Somewhere bar is a must for a sunset drink. There's a great outdoor living room (with fireplace) at the lobby bar. Of course, there is the main Margaritaville restaurant on the second floor.\n\nI splurged for a premium room and it was worth it. It is the same size as the other rooms, but it had a panoramic view of NYC. The island aesthetic is the same here at other Margaritaville resorts. The lighting fixtures are Margarita glasses. Rooms are done in tropical décor. It has a resort vibe, which is why I never left the hotel for my entire trip. To top it off, it is an exceptional value for the money.",
"review_images": null,
"user_profile": {
"name": "IdRatherBeInStBarths",
"url": "https://www.tripadvisor.com/Profile/IdRatherBeInStBarths",
"image_url": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/f1/79/default-avatar-2020-21.jpg",
"location": "Lodi, New Jersey",
"reviews_count": 25
},
"responses": [
{
"title": "Lauren Nordstrom",
"text": "Hi IdRatherBeInStBarths,\n\nThank you for taking the time to write a review after your recent stay at Margaritaville Resort Times Square! We are thrilled to hear that you enjoyed many aspects of your stay with us, especially, our pool, Food and Beverage venues, panoramic views, and island atmosphere! We thank you for your patronage and hope to welcome you back to our Resort soon!\n\nWarm Regards,\nLauren Nordstrom\nDirector of the Front Office",
"timestamp": "2021-10-22 00:00:00 +00:00"
}
]
},
{
"type": "tripadvisor_review_search",
"rank_group": 10,
"rank_absolute": 10,
"position": "left",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r815225024-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"date_of_visit": "2021-10-31 00:00:00 +00:00",
"timestamp": "2021-10-19 00:00:00 +00:00",
"title": "Wonderful Staff",
"review_text": "My husband and I had a fabulous three nights at this resort. We chose this hotel based on its location in Times Square near theaters. From the moment we checked in, every employee was friendly and helpful. The decor was so appealing! We ate at the restaurant a couple of times and enjoyed the food and margaritas. Special thanks to our servers Karen and Carl and the bellman Miguel! \n",
"review_images": null,
"user_profile": {
"name": "Deborah C",
"url": "https://www.tripadvisor.com/Profile/DeborahC2494",
"image_url": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/df/99/default-avatar-2020-40.jpg",
"location": null,
"reviews_count": 2
},
"responses": [
{
"title": "Lauren Nordstrom",
"text": "Hi DeborahC2494,\n\nThank you for your feedback on our central location, friendly staff, delightful details, and Food and Beverage venues! We are pleased to hear that you enjoyed the service that Karen, Carl and Miguel were able to provide! We thank you for your patronage and hope that you will join us for another New York adventure soon.\n\nWarm Regards,\nLauren Nordstrom\nDirector of the Front Office",
"timestamp": "2021-10-22 00:00:00 +00:00"
}
]
}
]
}
]
}
]
}
Description of the fields for sending a request:
Field name
Type
Description
id
string
task identifier unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time
As a response of the API server, you will receive JSON-encoded data containing a tasks array with the information specific to the set tasks.
Description of the fields in the results array:
Field name
Type
Description
version
string
the current version of the API
status_code
integer
general status code
you can find the full list of the response codes here Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions
status_message
string
general informational message
you can find the full list of general informational messages here
time
string
execution time, seconds
cost
float
total tasks cost, USD
tasks_count
integer
the number of tasks in the tasks array
tasks_error
integer
the number of tasks in the tasks array that were returned an error
tasks
array
array of tasks
id
string
task identifier unique task identifier in our system in the UUID format
status_code
integer
status code of the task
generated by DataForSEO; can be within the following range: 10000-60000
you can find the full list of the response codes here
status_message
string
informational message of the task
you can find the full list of general informational messages here
time
string
execution time, seconds
cost
float
cost of the task, USD
result_count
integer
number of elements in the result array
path
array
URL path
data
object
contains the same parameters that you specified in the POST request
result
array
array of results
url_path
string
URL path received in a POST array
type
string
search engine type in a POST array
se_domain
string
search engine domain in a POST array
check_url
string
direct URL to search engine results
you can use it to make sure that we provided accurate results
datetime
string
date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00
title
string
title of the ‘reviews’ element in SERP
the name of the local establishment for which the reviews are collected
location
string
location of the local establishment
address of the local establishment for which the reviews are collected
reviews_count
integer
the total number of reviews
rating
object
rating of the corresponding local establishment
popularity rate based on reviews and displayed in SERP
rating_type
string
type of rating
here you can find the following elements: Max5, Percents, CustomMax
value
float
the average rating based on all reviews
votes_count
integer
the number of votes
rating_max
integer
the maximum value for a rating_type
items_count
integer
the number of reviews items in the results array
you can get more results by using the depth parameter when setting a task
items
array
found reviews
you can get more results by using the depth parameter when setting a task
type
string
the review’s type
possible review types: "tripadvisor_review_search"
rank_group
integer
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group
rank_absolute
integer
absolute rank among all the listed reviews
absolute position among all reviews on the list
position
string
the alignment of the review in SERP
can take the following values: right
url
string
URL of the review
rating
object
the rating score submitted by the reviewer
rating_type
string
the type of the rating
can take the following values: Max5
value
float
the value of the rating
votes_count
integer
the amount of feedback
in this case, the value will be null
rating_max
integer
the maximum value for a rating_type
the maximum value for Max5 is 5
date_of_visit
string
date of the reviewer’s visit to the local establishment
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00
timestamp
string
date and time when the review was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00
title
string
title of the review
review_text
string
content of the review
review_images
array
contains URLs of the images used in the review
url
string
URL of the image used in the review
user_profile
object
information from the reviewer’s profile
name
string
reviewer’s profile name
url
string
URL of the reviewer’s profile
image_url
string
URL of the reviewer’s profile image
location
string
URL of the reviewer’s profile image
reviews_count
string
total number of reviews submitted by the reviewer
responses
array
contains information about the owner’s response
title
string
title of the owner’s response
indicates the owner’s name
text
string
text of the owner’s response
timestamp
string
date and time when the review was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00
